home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / C / Applications / BYacc-CW 1.9 / README (Mac) < prev    next >
Text File  |  1995-10-14  |  3KB  |  68 lines
  1. This is a yet another port of Berkeley Yacc 1.9 to the Macintosh.
  2.  
  3. Basically I took the sources from one of the many places on the net
  4. that had it, reworked the mainline slightly, fiddled a bit with the
  5. generated code so that it would work with Metrowerks CodeWarrior 6
  6. and bolted on a GUI with my tool "GIJO".
  7.  
  8. To use it, just drag-and-drop your .y file onto the Yacc icon.  If you
  9. forget this and just open the application, it will use StandardGetFile
  10. to prompt for a text file.  Once a file is provided, the GUI is pretty
  11. self explanatory to anyone who has used Yacc on unix.
  12.  
  13. About the only thing that isn't obvious is that if you hold down option
  14. when you click the "Yacc" button, it will save the current settings in
  15. the document that you dropped on the application; this allows you to
  16. set up your custom settings once for each document then just drag/drop/
  17. hit return for all further Yacc sessions.
  18.  
  19. I have included the complete source because I had to add prototypes to
  20. every function and I rearranged some of the sources slightly to minimize
  21. prototype requirement; well I didn't *have* to but I decided that I would
  22. for my own peace of mind.
  23.  
  24. robert.corbett@eng.Sun.COM is the original author of Yacc but has
  25. nothing to do with this Mac port.  Direct all questions via email to 
  26. Jeff Laing <jeffl@suburbia.apana.org.au>.
  27.  
  28. Disclaimer:
  29.  
  30. I got it working enough for me to use it.  I use it on a reasonably
  31. regular basis but only on fairly simple parsers.  I don't promise
  32. anything other than that.  Certainly its good enough to parse the 
  33. "Yacc.g" file - take a look.
  34.  
  35. Whilst this software is provided completely for free as intended by
  36. its author (see the file README), if you think I deserve a pat on
  37. the back for doing it, send ten of your countries major currency
  38. (Dollars, Pounds, etc; not Pennies, Cents) (cash is fine, just wrap
  39. it in carbon) to
  40.  
  41.     Tristero Computer Systems
  42.     P.O. Box 120
  43.     Northcote
  44.     Vic 3070
  45.     Australia.
  46.  
  47. But if you don't think so, just ask yourself why *you* haven't done it
  48. and why I bothered to.  No obligation.
  49.  
  50. The GIJO software will be released a little more formally as soon as
  51. I get the documentation to a state that I am not embarassed by.  You
  52. should be able to work out how to make minor changes just by looking
  53. at the "Yacc.g" file.  GIJO can be considered freeware with just
  54. one restriction:  GIJO may *not* be used to provide a user interface
  55. for "gnu-bison" until FSF relax their restrictions on bison's use in
  56. non-GPL projects;  in effect, I object to their restriction and am
  57. voicing my opinion in the same way they have.  Till they do, just 
  58. use YACC.
  59.  
  60. As previously stated, I ported this software so I could use it.  It
  61. seems to work for me.  I make no claims as to the usability of the
  62. software (like all good disclaimers); if it doesn't work as advertised
  63. or causes you to lose money, time, children, etc, well don't send me
  64. the money.  Having said that, if you have problems, email me at
  65. <jeffl@suburbia.apana.org.au> and we can try to work it out.
  66.  
  67. Jeff Laing
  68. Tristero Computer Systems